home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / basic / menurtn.com / MENURTNS.DOC < prev    next >
Encoding:
Text File  |  1990-10-05  |  8.0 KB  |  211 lines
  1.  
  2.                 MENURTNS.DOC for MENURTNS.QLB and MENURTNS.LIB
  3.  
  4.      The following documentation explains and gives examples of paramaters
  5. to pass to the Functions available in this QuickBASIC Library.  The
  6. following QuickBASIC Library contains seven routines as follows:
  7.  
  8. GetTime$()
  9.      This function can be used just as you would the DOS and BASICA TIME$
  10.      Function.  GetTime$ returns the time as 12 hour clock with am or pm.
  11.           EXAMPLE: PRINT GetTime$ could return "10:57 am"
  12.  
  13. GetDate$()
  14.      This function can be used just as you would the DOS and BASICA DATE$
  15.      Function.  GetDate$ returns the date as long international.
  16.           EXAMPLE: PRINT GetDate$ could return "August 25, 1990"
  17.  
  18. Shadow%(Row%, Col%)
  19.      This function will replace any character at the given location,
  20.      including blinking characters with the same character as Grey on Black.
  21.           EXAMPLE: Dummy = Shadow%(10, 10) would return a Grey on Black
  22.                    character if one exists.
  23.  
  24. WaitKey$(Row%, Col%, WaitText$)
  25.      This function will print the WaitText$ string at Row%, Col% on the
  26.      screen, wait for a key press and then return whatever key was pressed.
  27.           EXAMPLE:
  28.                   DO
  29.                      Response$ = WaitKey$(10, 10, "Press RETURN to continue")
  30.                   LOOP UNTIL Response$ = CHR$(13)
  31.  
  32. MenuBar%(Row%, Col%, MenuStr$, FgColor%, BgColor%, ReversedColor%)
  33.      This function will return the Integer number of the selection choosen.
  34.      The MenuBar% function automatically makes a one line menu with a
  35.      highlighted section of the bar that scrolls around the menu, or you can
  36.      choose a menu selection from the Hot keys which is the first letter of
  37.      each selection if Capitalized.  Colors are set within the parameters but
  38.      the Highlighted Foreground color will always be High-Intensity White.
  39.           EXAMPLE:
  40.      MenuStr$ = " Help  Menu-2  Time  Date  Quit "
  41.      SELECT CASE MenuBar%(10, 10, MenuStr$, Black, Cyan, Red)
  42.         CASE 1
  43.            This would be the Help selection
  44.         CASE 2
  45.            This would be the Menu-2 selection
  46.         CASE 3
  47.            This would be the Time selection
  48.         CASE 4
  49.            This would be the Date selection
  50.         CASE else
  51.            This would be the Quit selection
  52.      END SELECT
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                    (Page 1)
  64.  
  65.  
  66.  
  67.  
  68. MenuWindow%(Row%, Col%, ShadDir$, MenuTitle$, MenuStr$, OutLineColor%,_
  69.             WindowBgColor%, WindowFgColor%, ReversedColor%)
  70.      This function will return the Integer number of the selection choosen.
  71.      The MenuWindow% function automatically makes a window menu with a
  72.      highlighted section of the bar that scrolls up and down through the menu,
  73.      or you can choose a menu selection from the Hot keys which is the first
  74.      letter of each selection if Capitalized.  Colors are set within the
  75.      parameters but the Highlighted Foreground color will always be
  76.      High-Intensity White.  Also, a shadow can be specified with upper or
  77.      lower case "L" for left side, "R" for Right side or "" for no shadow.
  78.      The Menu Title will automatically be centered and truncated if
  79.      necessary to fit it within the box top.
  80.           EXAMPLE:
  81.      MenuStr$ = " Help  Menu-2  Time  Date  Quit "
  82.      SELECT CASE MenuWindow%(10, 10, "L", "MENU TITLE", MenuStr$, Blue,_
  83.             Cyan, Black, Red)
  84.         CASE 1
  85.            This would be the Help selection
  86.         CASE 2
  87.            This would be the Menu-2 selection
  88.         CASE 3
  89.            This would be the Time selection
  90.         CASE 4
  91.            This would be the Date selection
  92.         CASE else
  93.            This would be the Quit selection
  94.      END SELECT
  95.  
  96. DrawBox(URow%, UCol%, LRow%, LCol%, ShadDir$, BoxTitle$, OutLineColor%,_
  97.         WindowBgColor%, WindowFgColor%)
  98.      The DrawBox sub will draw a box at the given location specified by
  99.      the upper left corner and the lower right corner.  Colors are set
  100.      within the parameters.  Also, a shadow can be specified with upper or
  101.      lower case "L" for left side, "R" for Right side or "" for no shadow.
  102.      The Box Title will automatically be centered and truncated if necessary
  103.      to fit it within the box top.
  104.           EXAMPLE:
  105.      CALL DrawBox(2, 9, 14, 74, "l", "BOX TITLE", Blue, Cyan, White + Bright)
  106.  
  107.  
  108.      NOTE:
  109.  
  110.      As a QuickBASIC hobbyist programmer, I'm sure that anyone that has
  111. received this Library is, or is on the way to becoming a QuickBASIC
  112. programming enthusiast also.  This is my first attempt at a SHAREWARE
  113. product, and will more than likely determine if I will produce any more
  114. software for SHAREWARE.
  115.  
  116.      As seen above, I have created several functions that may enhance many
  117. programs that other programmers such as yourself has spent many hours
  118. creating.  So, below I have created a Registration form for anyone that
  119. thinks they may use any of these routines in programs for other than your
  120. own use.  If your just going to use these routines for your own programs,
  121. then no registration is necessary, otherwise, you can specify your own
  122. registration fee, depending on your anticipated use.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                    (Page 2)
  130.  
  131.  
  132.  
  133.  
  134.                          REGISTRATION FOR MENURTNS.LIB
  135.  
  136.  
  137.               NAME:_____________________________________________
  138.  
  139.             STREET:_____________________________________________
  140.  
  141.               CITY:________________ STATE:__ ZIP CODE __________
  142.  
  143.  
  144.  
  145.                     SUGGESTED REGISTRATION FEES OUTLINE:
  146.  
  147.                     Personal Use: ---------------   FREE
  148.  
  149.                     Light User: ----------------- $ 5.00
  150.  
  151.                     Moderate User: -------------- $10.00
  152.  
  153.                     Heavy User: ----------------- $15.00
  154.  
  155.                     Source Code: ---------------- $25.00 *
  156.  
  157.                   * Plus $2.50 for Diskette and Diskette Mailer
  158.                     or send Diskette and Mailer with Postage
  159.  
  160.                     Please send registration form to:
  161.  
  162.                     Robert R. Smith
  163.                     3812 Red Bud
  164.                     Imperial, MO  63052-1161
  165.  
  166.                                      OR
  167.  
  168. You can also order with MasterCard, Visa, American Express or Discover Card
  169. from Public (Software) Library by calling 800-2424-PSL or 713-524-6394 or by
  170. FAX to 713-524-6398 or by CompuServe to 71355,470 or by mail to PSL; P.O. Box
  171. 35707; Houston, TX 77235-5705.
  172.  
  173.  
  174.          ----------------end-of-author's-documentation---------------
  175.  
  176.                          Software Library Information:
  177.  
  178.                     This disk copy provided as a service of
  179.  
  180.                            Public (software) Library
  181.  
  182.          We are not the authors of this program, nor are we associated
  183.          with the author in any way other than as a distributor of the
  184.          program in accordance with the author's terms of distribution
  185.          or as a means of registering the program.
  186.  
  187.          Disks in the PsL are updated  monthly,  so if you did not get
  188.          this disk directly from the PsL, you should be aware that the
  189.          files in this set may no longer be the current versions. Also,
  190.          if you got this disk from another vendor and are having prob-
  191.          lems,  be aware that  some files may have become corrupted or
  192.          lost by that vendor. Get a current, working disk from PsL.
  193.  
  194.          For a copy of the latest monthly software library newsletter
  195.          and a list of the 2,500+ disks in the library, call or write
  196.  
  197.                            Public (software) Library
  198.                                P.O.Box 35705 - F
  199.                             Houston, TX 77235-5705
  200.  
  201.                                 1-800-2424-PSL
  202.                                  MC/Visa/AmEx
  203.  
  204.                           Outside of U.S. or in Texas
  205.                           or for general information,
  206.                               Call 1-713-524-6394
  207.  
  208.                           PsL also has an outstanding
  209.                           catalog for the Macintosh.
  210.  
  211.